Skip to content

docs: add desktop Feature Manifest reference, reorganize feature definition#795

Open
jaredlockhart wants to merge 1 commit intomainfrom
2026-02-25-feature-manifest-docs
Open

docs: add desktop Feature Manifest reference, reorganize feature definition#795
jaredlockhart wants to merge 1 commit intomainfrom
2026-02-25-feature-manifest-docs

Conversation

@jaredlockhart
Copy link
Contributor

Summary

Creates a comprehensive desktop FeatureManifest.yaml reference doc and reorganizes the generic feature definition page.

New doc: Desktop Feature Manifest Reference (docs/platform-guides/desktop/feature-manifest.md)

  • Complete feature-level property reference: description, owner, hasExposure/exposureDescription, isEarlyStartup, allowCoenrollment, applications, schema
  • Complete variable-level property reference: type, fallbackPref, setPref, enum
  • setPref vs fallbackPref comparison table with behavior differences
  • Variable types (boolean, string, int, json) with examples
  • Real-world examples: simple feature gate, multi-variable, early startup, co-enrollment
  • Cross-links to Feature API, Pref Experiments, and Co-enrolling Features docs

Reorganization:

  • feature-definition.md rewritten as a crossroads page → Desktop manifest ref, FML spec, Cirrus guide
  • feature-api.mdx registration section slimmed down with cross-link to full reference
  • Sidebar updated: new doc added as first item under Desktop

Fixes #794

🤖 Generated with Claude Code

…nition

Because

* The desktop FeatureManifest.yaml schema had no dedicated reference —
  only a brief example in feature-api.mdx
* The generic feature-definition.md was a thin page that didn't clearly
  direct users to the right platform-specific docs
* Engineers defining new desktop features had to piece together the
  schema from scattered sources

This commit

* Creates a comprehensive Desktop Feature Manifest Reference doc
  covering all feature-level properties (description, owner,
  hasExposure, isEarlyStartup, allowCoenrollment, applications, schema),
  all variable properties (type, fallbackPref, setPref, enum), a
  setPref vs fallbackPref comparison, and real-world examples
* Adds the new doc to the sidebar under Desktop (first item)
* Slims down the registration section in feature-api.mdx with a
  cross-link to the full reference
* Rewrites feature-definition.md as a clear crossroads page pointing
  to Desktop manifest reference, FML spec, and Cirrus guide

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add desktop Feature Manifest reference and reorganize feature definition

1 participant